Signal Definition Wizard

In the step list, you can assign a signal sequence from an external file to a signal declared in TPT.

To insert signals in step lists by means of the Signal Definition Wizard, select a step list variant or a step test case in the Project view, open the Content view, and click Import signals from file .

Signals listed in the "Available Signals" sections

File

Select an external file. The signal names detected in this file are listed in the Available Signals section.

The file format supported are: CSV, DAT, MAT, MDF, MF4, TPTBIN, XLS, or XLSX, see Data Import - supported Files Formats.

Mapping (optional)

Select a TPT mapping with Rename flavor, see Mapping Flavor - Rename, from the drop-down list. TPT matches the signal name from the external file to the external name of the signal in TPT.

When you select a mapping, you cannot specify a Channel pattern.

Channel pattern (optional)

With the help of the channel pattern, TPT can match the signal names from the external file to signal names in TPT.

The channel pattern must always contain the ${CHANNEL} expression since it serves as the representative for the channel name. Use for the rest the regular expression syntax.

TPT will scan for the channel name in TPT that is equal to the name of the external signal. By specifying a prefix and/or postfix, you tell TPT to ignore these parts of the external signal name when searching for the signal in your project.

Example

In TPT, there are three channels specified named a, b, c. Your external file contains five signals named CAN0_a_ETK2, CAN0_b_ETK2, CAN0_c_ETK1, testchan1, and testchan2.

When you enter the pattern CAN\d_${CHANNEL}_EKT\d, TPT skips the prefix and postfix and searches for the signal names a, b, and c.

If you try CAN\d_b_ETK[0-9], TPT will not assign the signal found to the channel "b" and an error message is shown.

Use Ctrl+Space in the Channel pattern field to view the previously used patterns.

Available signals

This section list all signals detected in the external file.

Include parameters

Select this check box to list also the parameters of your TPT project in the upcoming dialog (Assignment of signals to channels) to assign external signal values to parameters.

Assignment of signals to channels

Assignment of signals to channels

Import

Select this check box to select a signal name from the external file from the Signal drop-down list.

Channel

This columns lists all channels of your TPT project. When you have selected the Include parameters check box, also the parameters of your TPT project are listed.

Signal

In case a channel pattern has been added or a rename mapping has been selected, TPT assigns the appropriate external signals to the signals of your TPT project automatically.

You can also manually select an external signal name from the drop-down list.

The same signal sequence can be assigned to several signals in TPT.

Factor

By default, the factor is 1.0. You can change this value. The values of the external signal are multiplied with the factor entered.

If the factor is greater 1.0, TPT imports or embeds the signal first, and adds a Channel step with the signal and the specified factor.

Applied factor

Offset

By default, the offset is 0.0. You can change this value. The offset is added to the values of the external signals.

If the offset is greater 0.0, TPT imports or embeds the signal first, and adds a Channel step with the signal and the specified offset.

Applied offset

Select signal import method

You can either link to the signal source or embed the signal data into your project.

Link Signal Source

The signal is linked to the project via a relative path; the signal cannot be edited from within the project. The signal sequence is loaded during the test execution so the most recent signal data is loaded. See also Step Type - Import signal.

Embed Signal Data

The signal is part of the project; the signal can be edited from within the project. See also Step Type - Embedded signal.

Wait for last sample before continuing to the next section of the step list

Select this check box to add a Wait... step after the Import signal step or Embedded signal step, see Step Type - Wait.... The transition to the next section will only be triggered after the last sample of the longest signal.

Select signal interpolation mode

You need to select one of the two signal interpolation modes.

Hold Last Value

The value of a sample is considered valid until a subsequent sample is reached.

Linear Interpolation of Signal Values

The values of a sample and its successor will be interpolated in a linear way.

Select signal time shift

Choose if you want to shift the times axes to the left or right by n seconds. This way, you can remove or insert additional samples at the signal start point or before a given time value.

Or choose to do not shift the time axis at all. By default, the time axes are not shifted.

Set last channel value

If you have chosen to Embed Signal Data, you can insert an extra sample after the last imported value with a specific value. This step is not mandatory and can be skipped.

After completing the process, a step is created in the step list.

Import signal step